PATH Mac OS 8 and 9 Developer Documentation > Text and Other International Services > Apple Type Services for Unicode Imaging (ATSUI) > Apple Type Services for Unicode Imaging Reference
     

ATSUCreateAndCopyTextLayout

Creates a copy of a text layout object.

OSStatus ATSUCreateAndCopyTextLayout (
                     ATSUTextLayout iTextLayout,
                     ATSUTextLayout *oTextLayout);
iTextLayout
A reference of type ATSUTextLayout. Pass a reference to an initialized text layout object whose contents you want to copy. You cannot pass NULL for this parameter.

oTextLayout
A pointer to a reference of type ATSUTextLayout. On return, the newly-created text layout object. You cannot pass NULL for this parameter.

function result
A result code. See Result Codes.
DISCUSSION
The ATSUCreateAndCopyTextLayout function creates a copy of a text layout object that contains the same text layout attribute values, style runs, and soft line breaks. ATSUCreateAndCopyTextLayout does not copy reference constants or layout caches.

SPECIAL CONSIDERATIONS
ATSUCreateAndCopyTextLayout allocates memory in your application heap, unless you designate a different heap by calling the function ATSUCreateMemorySetting.

VERSION NOTES
Available beginning with ATSUI 1.1.

© 2000 Apple Computer, Inc. – (Last Updated 25 Jan 00)